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INTRODUCTION TO BASIC-E 
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BASIC-E IS A COMPILED, SCIENTIFICALLY-ORIENTED, FAST-EXECUTING ] 
O  234s1c DANGUAGE PROCESSOR.  BASIC-E WAS WRITTEN BY GORDON E. i 
D — oa o e THE DAMOS” POSIORADUETE — SORO0E, NORMAL, 

CALIFORNIA. | | o a 


-PHE —BASIC=E LANGUAGE — FEATURES INCLUDE SEQUENTIAL AND ranDom———— | 
DISKETTE FILE CAPABILITIES, A WIDE RANGE OF PREDEFINED FUNCTIONS, $ 
USER-DEFINED FUNCTIONS, AND STRINGS UP TO 255 CHARACTERS LONG. 

—————HRRAYS MAY HAVE ANY NUMBER OF SUBSCRIPTS- AND MAY BE- STRING OR — | 
NUMERIC. IN A STRING ARRAY, EACH ELEMENT CAN BE A STRING OF UP ; 
TO 255 CHARACTERS. NUMBERS IN BASIC-E ARE REPRESENTED INTERNALLY 

——IN-— BINARY FLOATING POINT- AND APPROXIMATELY 7- SIGNIFICANT DECIMA ———-—- 
DIGITS ARE CARRIED.  BASIC-E CURRENTLY BHAS NO PROVISION FOR 
FORMATTED PRINTING, AND NO PROVISION FOR CALLING MACHINE LANGUAGE T 

o | EI TO CI 








UNLIKE MOST MICROCOMPUTER BASICS, BASIC-E IS NOT INTERACTIVE, a 

————— RATHER THANTYPINGSTATEMENTS INTO THE BASIC LANGUAGE PROCESSOR, ——" 
THE USER PREPARES A FILE CONTAINING THE DESIRED PROGRAM (USUALLY i 

THE EDITOR 1S USED TO DO THIS), THEN COMPILES IT WITH THE ¿a 

7 BASIC=E COMPILER, THEN -EXECUTES -IT AS MANY TIMES AS HE WISHES———— 
WITH THE BASIC-E RUN-TIME INTERPRETER. SINCE THE PROGRAM IS Pl 
STORED. IN SOURCE LANGUAGE FORM ON A DISK FILE, MANY OF THE = = B 
A a‘ O TACTITTIES — ED—MIPE a ooa 
BE APPLIED TO IT. SIMILARLY, DATA FILES PRODUCED ÅND USED BY E 
BASIC—E PROGRAMS ARE IN ASCII FORM AND CAN BE EDITED, TYPED, Y 
VEA A 








= BASIC-E OPERATES ON THE IMSAI 8989 UNDER THE CP/M FLOPPY DISK 
OPEN SISTEMA 
SYSTEM IS DISTRIBUTED IN A 16K VERSION; TO UTILIZE ADDITIONAL | 
RAM, A LARGER SYSTEM MUST BE GENERATED WITH THE CPM AND SYSGEN A 
ry COMMANDS- AS” DESCRIBED IN THE CP/M SYSTEM USER” senin oa E 


wm na en 














GORDON EUBANKS” "BASIC-E REFERENCE MANUAL” FOLLOWS THIS i 
—— INTRODUCTION? TT —SHÓULD” BE” CONSUETED FOR- e id 
INFORMATION THAN GIVEN IN THE FOLLOWING SUMMARIES. i 
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RANGE 2.7E-39 TO 3.6£38 
A O SE A Fo SIGNIFICANT DECIMAL —DIGITS ARE] 
oo REPRESENTED INTERNALLY; NUMBERS ARE ROUNDED TO 6 DIGITS 


> OR PRINTOUT, OUTPUT TO FILES, AND BY. TEE STRS 
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a SIRINGS — a 


-MAY CONTAIN Ø TO 255 ASCII CHARACTERS: STORAGE FOR 
STRINGS IS AUTOMATICALLY ALLOCATED AS REQUIRED DURING 
STRING VARIABLE) EACH ELEMENT IS A SEPARATE STRING OF 


CHARACTERS, 
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NAMES (IDENTIFIERS) 
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o TABLE NAMES MAY BE UP TO 31 
FIRST CHARACTER MUST BE A LETTER; = REST MUST BE 


LETTER, ro OR PERIOD. 


NUMERIC OPERATORS 
e o e) T F: Boner eaa AA 
$. <=, p >=, <> AL 
A S ee, LE, GT, CE, EQ, NE E (SAME AS S PRECEDING LINE) 





STRING OPERATORS el 


+ (CONCATENATION) 
RELATIONAL OPERATORS AS ABOVE 
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E STATEMENTS - GENERAL 


~ INE NUMBERS -ARE -OPTIONAL AN -BASTC=E- PROGRAMS EXCEPT As 
REQUIRED ON LINES REFERENCED BY GOTO, GOSUB, ETC. 
MULTIPLE STATEMENTS ON ONE LINE SHOULD BE SEPERATED BY 
A MA a o a 
| | E STATEMENT ON THE LINE). A STATEMENT MAY BE CONTINUED | 


n ON THE NEXT LINE IF A \ PRECEDES THE CARRIAGE RETURN. 
aoo o oa NAMES AND REMARKS MAY BE USED FREELY AS ——— 
THEY DO NOT EFFECT THE SIZE OF THE PROGRAM AFTER 
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IF ... THEN LINE NUMBER 

IF ... THEN ANY STATEMENT | , | Ñ 
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GOSUB | 
RETURN e 
zo a. COTO EST Or ENE NUMBERS TM 
=n ON ... GOSUB LIST OF LINE NUMBERS | o d 
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REM 


De STATEMENTS 
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DN NAME (DIMENSIONS), NAME(DIMENSIONS) p 2.0. 


AA a a a o 
| BE DIMENSIONED AND THE DIM STATEMENT SHOULD APPEAR IN | 
| - THE SENT BEFORE THE ARRAY IS REFERENCED. 
EXAMPLES: DIM N(109) | 
DIM BIG(2,4, S, 92 2 E DATASTRINGS$ (10, 5 23) 
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USER-DEFINED FUNCTIONS . 
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IT ER INNAME KRCUNENTS J EXPRESS TON 7-72 


EXAMPLES: DEF FNA(X+Y)=xX+Y-A a ) a 
FPNXY> como trasporte a 
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| SEQUENTIAL FILE OPERATIONS 
E 2 $ ILE VARIABLE SI VAR TABLE 5 e E A x_x_E _ o —— 4 


OPENS ONE OR MORE FILES. EACH STRING VARIABLE'S 
VALUE IS TAKEN ÁS TEE NAME OS rT TO OPEN BET 
| e FIRST FILE OPENED IS #1, THE SECOND, +42, ETC. UP 3 
TO TWENTY FILES CAN BE OPEN AT ONE TIME. NOTE i 
AAA AT TES FILE NA TDT SM -MUST -o 0 
SPECIFIED VIA THE VALUE OF A STRING VARIABLE; NO $ 
OTHER FORM WILL WORK. 


R a a A A A A A aaea A A A A A A A A naa e e 


PRINT HFILENUMBER; LIST 


O A A a A 


o OUTPUTS A LIST OP VARIABLES OR -EXPRESSIONS To— ie 
INDICATED TILE. 'FILENUMBER IS A NUMERIC 

EXPRESSION; NOTE THE # BEFORE FILENUMBER AND THE ; i 

E ERN E TS 


READ AFILENUMBER; LIST — 
READS A LIST OF VARIABLES FROM INDICATED OPEN 
FILE. E 


A A A A A A A e PERITO PRENSAS ¡TAO PERRERA A A AAA PA mp e a a a a a a m A n p aa e n e 


-o CLOSE FILENUMBER, FILENUMBER ... 
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(A AA PA A A A o a A O 


A ES O 0 ma as — Oo 
IF END #FILENUMBER THEN LINE NUMBER 





e = SPECIFIES LINE NUMBER TO GOTO IP- AND WHEN A 4 
Po SUBSEQUENT INPUT ATTEMPTS TO READ BEYOND THE END i 
Ea a O THE INDICAT ED DEO S TURE E E 


A ACCESS | FILE OPERATIONS 
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me A aa a æ em. 


FILE VARIABLES (RECORDLEN) , VARIABLES. (RECORDLEN) 





OPENS FILES —RECORDLEN— IS —aN——————| 
| EXPRESSION SPECIFYING THE LENGTH OF EACH RECORD IN i 

THE FILE, THAT 15, How MANY BYTES AE TO BE -. A 
IRAN SMITTED WITE EACH PRINT OR INPUT STATEMENT | 


o PRINT #FILENUMBER, RECORDNUMBER; LIST -o > E 
~ R PAD HFILENUMBER, RECORDNUMBERS TA. 


THESE ACCESS THE SPECIFIED RECORD OF A FILE. NOTE | i 
— O ARIST COMMA- BEFORE- THE RECORD NUMBER] 
~ o EXPRESSION AND A SEMICOLON AFTER T y 
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PREDEFINED NUMERIC FUNCTIONS $ 
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| tw ABS(X) : l 
e E E E i SOE a E E A O AN 
| o TOSI) 3 n | 


| a HYPERBOLIC COSINE - -o 
== O. o a O S r STOR T: ~ 
INP(X) INPUT FROM PORT X í 

INT(X) 

a P El Ho O O a 
-o POSII) OCARRIAGE POSITION OOO 
RD o o -RANDOM NUMBER BETWEEN g AND 1 -o g 
O ENT Xx o IS A O EE SE A EESE A a an ki 
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PREDEFINED STRING FUNCTIONS | 
| A 6 


e O A 7 REPRES EN ISA NY-STRI NG- EXPRESST eT A O 


asci) 
ao A S O 
LEFT (A$, LENGTH) i 
LEN(AS) | | =F 
ey qoo SMIDSCTAS,) STARTILENCTE) 31 N 
e o — RIGHTS (AS, LENGTH) a A 
STRS(I) 
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BASIC- -E OPERATION 
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TO USE BASIC-E YOU MUST HAVE AT LEAST 28K- or ray (many i 
APPLICATIONS WILL REQUIRE MORE) AND YOUR CP/M OPERATING - 
————————SYSTEM-MUST-BE-RELOCATED-FOR—THE-AMOUNT-OF-RAM-IN—USE WITE —— 

THE CPM AND SYSGEN COMMANDS AS DESCRIBED IN THE CP/M USER'S- 
GUIDE. | 


PER ii TA fi A NC a A A A A A A A A A A A A A A A 5 A A A 
F ne: RERET E AE a A 


BASIC-E SOURCE. PROGRAMS RESIDE ON DISKETTE FILES OF TYPE o 

o = BAS. USUALLY THEY ARE INPUT : FROM THE TERMINAL WITH THE - 
—— P/M EDITOR (ED) OR FROM PAPER TAPE OR OTHER MEDIA WITE TEE ———] 
PIP PROGRAM. LIKE ANY OTHER FILE, A BASIC-E PROGRAM MAY BE 

PRINTED OUT WITH THE CP/M TYPE OR LIST COMMAND, COPIED TO 
ANOTHER PILE WITE PIPS UPDATED WITH ED, ETC o S aa 
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BEFORE IT CAN BE RUN, A BASIC-E PROGRAM MUST BE COMPILED. 
THIS IS DONE WITH THE CP/M COMMAND 
BASIC-E NAME 
e- -WHERE "NAME" IS THE NAME OF THE FILE CONTAINING THE PROGRAM ~-i 


-THE COMPILATION OPERATION LISTS THE PROGRAM, TYPES ERROR 
MESSAGES IF ANY ERRORS ARE FOUND IN THE PROGRAM, AND 
AAA PRODUCES E NEW FILE VITE THE SAME NAME BUT OF TE IN AAÁAÁAÁAA AAA 


_THE COMPILED PROGRAM CAN THEN BE EXECUTED WITH THE COMMAND 

0 RUN-E NAME h 

PAE PROGRAM_—CAN-—BE—USED —AS—MANT —TIMES-—AS—DESTRED-—»Y-———— | 
REENTERING THE RUN-E COMMAND. 
e EE RR PROGRAM, EDIT TAE SOUROR- PIES CNAME- BAS) 7 | 
- RECOMPILE IT, THEN RERUN-E IT. -o - 
NOTES ON TEE "BASTO=E REFERENCE MANUEL-—————————— | 
1. THE COMMANDS TO COMPILE AND RUN A BASIC-E PROGRAM ARE E 

OT BASIC=E NAME” AND RONSE- NAME” y AS. DESCRIBED IN THB" 
~ OPERATION SECTION ABOVE, NOT "BASIC'NAME” AND "RUN NAME" AS E 
STATED IN THE BASIC-E REFERENCE MANUAL. i 

A a ADS E RS OS A E UI SMA cdo: A AS AI A SAN SANN 3 
2. THE COMPILER OPTIONS ARE SPECIFIED IN THE BASIC-E l 

COMMAND, AFTER THE FILE NAME, IN THE FORM: ; 

> : BASIC-E NAME $OPTIONS n d 
AND NOTIN THE SOURCE PILE—AS— SPECIFIED —IN——THE—BASIC=r h 
= REFERENCE MANUAL. IN. ADDITION TO THE OPTIONS DESCRIBED ON ; 

PAGES 66 AND 81 OF THE MANUAL, ONE ADDITIONAL OPTION IS 

a O A CAUSES -THE COMPILER TO OUTPUT 1TS LISTING-T07— f 


FEE LST: DEVICE INSTEAD OF THE CONSOLE. - 


ARA 





A Von ge IN TRELISTING PRODUCED BY THE- COMPILER AN" AFTER- = 
LINE NUMBER SUPPLIED BY THE COMPILER INDICATES THAT THE LINE E 

NUMBER IN THE SOURCE PROGRAM (PRINTED TO THE RIGHT OF THE *) : 
TY 1S NOT REFERENCED IN THE PROGRAM; n n a a 
Lp a. THE RANDOMIZE STATEMENT IS EFFECTIVE ONLY IF AN INPUT 4 
-STATEMENT EAS- BEEN EXECUTED EARLIER IN —THE——PROGRAM.—— THE- li 

VARIABLE TIME IT TAKES TEE USER TO RESPOND AT THE TERMINAL i 

IS USED TO RANDOMIZE THE RANDOM NUMBER GENERATOR. ; 
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A UN a mate 


PA A O - 
e 5, THE DESCRIPTION OF THE READ STATEMENT ON PACE 44 IS ~ 
; RATHER CONFUSED. THE THREE FORMS OF THE READ STATEMENT 


ARE: 


amatm O ae mm aee aala A A a aa aa e ie 


| | (1) [<LINE NUMBER>] READ  #CEIPRESSION), <EXPRESSION>; 
v -o _SVARIABLE» L, y <VARIABLE)] 


A 


TO READ A RANDOM RECORD FROM A SPECIFIED FILE. 


e serama e m a iaeei O PP Pf PPP PX ae a A e n iaeaea A A 
cr A a ea 


A A O A O o A ra an a a aaa 


q zm A Y [<LINE-NUMBER>]_ “READ HCEXPRESSION»3 a 
| | <VARIABLE>L, <VARIABLE)>) 


a a m a F READ THE NEXT SEQUENTIAL RECORD FROM Ap 
o SPECIFIED FILE. -o 


i TE san 3 F ECIIN EN UMBER>] READ <VAR 2 ABLES > < VAR m ARO -F 

TO READ VALUES FROM DATA A EN ON 4 
HT E AA a O 
| o 6. EXECUTION oF A RETURN STATEMENT FOR WHICH THERE WAS NO o á 
O ————GÓSUB TERMI NATES THE PROGRAM- WITE- NO ERROR- mn. o a o 


7. ERROR CODES THE COMPILER CAN PRODUCE, IN ADDITION TO 1 
TT TROSE GIVEN -ON PAGES 73 AND 74- OFTHE- MANUAL, INCLUDE: ETT 





a as = CARRIAGE RETURN OCCURS IN A STRING PROBE y 
xq o O CONSTANT A e a 


8. ERROR CODES THE RUN-TIME INTERPRETER CAN PRODUCE, IN 
o TO THOSE” GIVEN ON- PAGE 75 OF THE-MANUAL, INCLUDE: SE ESTR, 





or OVERFLOW: NUMBER TOO LARGE (WARNING; 
e ON A O CUPÓN CONTINUES) — E a oO O 


t 
ramarna ie maan Danaa ana ma A A A A A mae an ae an a aaa A aaae e aaa e a a e Ah 
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NF ATTEMPT TO OPEN MORE THAN 20 PILES 


E A A O 


o. STRING OVER: 255 CHARACTERS LONG 


A s senpa cm qu re E amo 


A ———ATTEMPT-TO -WRÍTE-A- STRING" o 
` ONTO A FILE ; 


HN cy o en EN O U G q MEMORT + 


oo NO? ENOUGH MEMORY O 








~ DW DISK WRITE ERROR: INCLUDES DISK FULL 
AND DISK DIRECTORY FULL. 





tr 


A S 
ni KNOWN BUGS on 

i 1. SOURCE FILE LINES OVER 80 _ CHARACTERS CAN PRODUCE 
EA = NC ORREC T-COMPI Tr Vat. Ana a A AN E E a a N 


6 2. IF THE SOURCE FILE ENDS BETWEEN QUOTES (I. E. TEE SECOND y 
WS MISSING IN £ QUOTED TEXT INTET- LAST STATEMENT, EE 
COMPILER WILL HANG UP. $ 


—— a MORE THAN 20 FILES CAN CRASH -THE o 4 
INTERPRETER. a 


i COMPILER ENHANCEMENTS 


A a A ai aa a a A Aa a a e Aa a a aaa a aami aada a a R a a ai a a e i a a e a a aa a a i aii a a a 
Aee amanenna nr ANN Drda a ari ian Vii aan a 


A. OPTIONS ARE NOW SPECIFIED IN THE BASIC-EB STATEMENT 
INSTEAD OF IN THE SOURCE FILE, PERMITTING s THEM 
AAA VITEOUT EDITING TEF PT D T To II 


© B. A CARRIAGE RETURN BETWEEN QUOTES NOW CAUSES A QS. j 
ERROR INSTEAD OP INCORRECT COMPILATTON= == >. 


2. RUN-TIME ENHANCEMENTS a r 
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O ES 


a A. NUMBER OF OPEN FILES INCREASED FROM 6 TO 20. 
A  MPILERCEUOS FI TX ED NC LD  ——— Y 
| A OP FILES OVER 16K LONG NOW WORKS i 
© CLOSE STATEMENT Now COMPILES CORRECTLY 





eeen i ai A 


DAS O N=TIME-T NTER PRETER- B UGS-FIXED =TNC amw A | 


INTEGER NUMBERS ALWAYS PRINT SORES 


A mame A e OS A n e e «e A A A e e A A a A a mema  a e A 
O a e ee a n e: PISO PERRA RAE DEEPA cr Pm ea mp - II 
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